Skip to main content
Version: 1.2.x

Deploy

Sandbox resource deployment manager for local directory deployment and template formatting.

deploy_working_dir - Deploy Local Directory​

sandbox = Sandbox(config)
deploy = sandbox.deploy

# Deploy local directory (auto-generated target path)
target = await deploy.deploy_working_dir(
    local_path="/path/to/local/project",
)
print(f"Deployed to: {target}")  # e.g., /tmp/rock_workdir_abc123

# Deploy to specific target path
target = await deploy.deploy_working_dir(
    local_path="/path/to/local/project",
    target_path="/root/workdir",
)

format - Template Variable Substitution​

# After deploy_working_dir, use ${working_dir} placeholder
cmd = deploy.format("mv ${working_dir}/config.json /root/.app/")
# Result: mv /tmp/rock_workdir_abc123/config.json /root/.app/

# Combine with custom variables
cmd = deploy.format(
    "cat ${working_dir}/${config_file}",
    config_file="settings.json"
)
# Result: cat /tmp/rock_workdir_abc123/settings.json

# Access working_dir directly
if deploy.working_dir:
    print(f"Current working directory: {deploy.working_dir}")

Multiple Deployments​

Subsequent calls overwrite previous working directory paths:

# First deployment
path1 = await deploy.deploy_working_dir(local_path="/project/v1")
print(deploy.working_dir)  # /tmp/rock_workdir_xxx1

# Second deployment (overwrites previous path)
path2 = await deploy.deploy_working_dir(local_path="/project/v2")
print(deploy.working_dir)  # /tmp/rock_workdir_xxx2